ZR RAW Extended
===============

Public release: 1.0
Internal build: 204
Release date: 2026-08-19

Requirements:
- Apple-silicon Mac with macOS 13 or newer.
- REDCINE-X PRO, installed automatically from RED through Homebrew.
- DaVinci Resolve Studio is optional. Resolve 21 is the validated release.
- Internet access during setup if Homebrew, Python, or FFmpeg is missing.

1. Run the installer. REDCINE-X PRO, Python, and FFmpeg are installed if needed.
2. The installer never opens Resolve or blocks on its scripting setting. To use
   Resolve later, install it and set External scripting using to Local, then
   restart Resolve. The app checks Resolve only when that engine is selected.
3. Control-click "Install ZR RAW Extended.app", choose Open, then confirm Open.
   This one-time step is required because this community project is not Apple
   notarized. The app opens the requirement checker safely in Terminal.
4. The app is placed in Applications first. Setup then installs or repairs
   REDCINE-X PRO, Python, FFmpeg, and the listener before opening the app.
5. Open ZR R3D Listener in the app to select one or more RAW directories.

If a required component later goes missing or stops working, the app identifies
it and offers Repair Installation. Repair checks only the affected requirements,
verifies the selected pipeline, and restores the autosaved queue without
changing RAW files or completed exports.

The app exports R3D/NEV through either DaVinci Resolve or REDCINE-X / REDline
as H.265 or Apple ProRes. Choose the processing engine from the main window;
the queue, listener, history, profiles, progress, and verification stay shared.
Resolve Temporal NR is available only with the Resolve engine.
Outputs are
always 10-bit 4:2:2, while preserving REDWideGamutRGB / Log3G10 without a CST.
NEV originals stay untouched
and use temporary R3D aliases for RED IPP2. Optional low-frequency noise
reduction uses full-frame 5-frame temporal analysis with Low, Medium, and
High strengths. Spatial noise reduction is disabled.
H.265 offers Lower 150 Mb/s, Standard 250 Mb/s, Higher 400 Mb/s, and a
25-800 Mb/s custom target. ProRes offers 422 Proxy, LT, standard, and HQ.

Before export, the queue shows file name, RAW type, resolution, frame rate,
duration, file size, date, and prior processing history. Previously processed
clips are unchecked by default, show their earlier output location, and can be
explicitly checked again for a non-destructive re-compression.
Add individual files, whole folders, or drag either into the queue. Queue items
can be removed or cleared, and queues autosave for crash recovery. Save Queue
creates a named session available from the Recent menu.
Each clip can use its own H.265 or ProRes profile and custom bitrate. Apply to
All Queue Items copies the current default to every row. Profile changes update
size estimates immediately without rescanning RAW metadata.
Each queued clip has its own progress bar and shows RAW size, estimated output
size, selected target or nominal bitrate, and the estimated percentage smaller.
Live stage labels distinguish preparing, decoding, compressing, finalizing, and
verification. Queue and per-clip time remaining appear after enough real
progress exists to form a useful estimate. The menu-bar icon becomes a compact
progress ring during exports.
After export, estimates are replaced by the measured output size, actual file
rate, and exact percentage smaller (or larger for a high-data-rate profile).
Queue thumbnails are generated quickly from same-stem camera JPEG or MP4 proxy
files and cached locally. RAWs without a matching sidecar show Preview unavailable.
Automatic listener runs use the saved H.265/ProRes, custom bitrate, N-RAW, and
noise-reduction settings. Every automatic batch pauses for a visible five-second
review with Cancel and Review before Resolve compression begins.
If DaVinci Resolve is already open, Resolve-mode compression pauses before
creating a project so the user can save and quit their current work. During an
export, switching away from the app-owned temporary project safely stops that
export and never closes or modifies the newly opened project.
Before every run, a quiet preflight checks source availability, required tools,
destination permissions, final-output space, and peak temporary space. It stays
out of the way when ready and blocks only unsafe runs. Finish Clip and Stop
lets active work verify before preserving the unfinished queue for one-click
recovery. Immediate cancellation remains available separately.
Completion notifications include Open Export Folder and View Failed Clips.
Completion sound can be disabled in Advanced processing. Failed and interrupted
queues gain an All / Needs Attention filter, and each completed row can reveal
its exact output. A one-click diagnostic report records app, Mac, configuration,
storage, and sanitized errors without footage names, personal paths, or media.
New installations receive a focused three-step walkthrough.
The menu-bar lightning icon opens the main window, turns ZR R3D Listener on or
off, opens listener settings, or quits the app. Closing the main window keeps
this lightweight menu-bar controller available. The menu clearly distinguishes
quitting while the listener remains active from turning the listener off and
quitting, and it prevents unsafe quitting during an active export.

DaVinci Resolve is not bundled and remains subject to Blackmagic Design's
license. Internet is required if Homebrew, Python, or FFmpeg must be installed.
The installer uses a pinned Python 3.13 runtime for Resolve scripting stability.
This project intentionally uses a free ad-hoc integrity signature and is not
Apple notarized. The installer clears quarantine from the installed app.
